Skip to main content

Organizing Your Documentation with the File Tree

The file tree is your command center for organizing and structuring your documentation.

Understanding the Structure​

Your documentation is organized in a hierarchical system with different levels:

  • Navbar Dropdowns - Top-level menus in your site's navigation bar
  • Navbar Items - Individual links that appear in dropdowns or directly in the navbar

Content Organization Level​

  • Categories - Main folders that group related content (orange folder icons)
  • Groups - Sub-folders within categories for further organization (indigo folder icons)
  • Pages - Your actual documentation content (document icons)
  • Subpages - Nested pages within groups for detailed topics

Quick Actions Panel​

At the top of the file tree, you'll find Quick Actions - your shortcut to creating new content:

  • Navbar Dropdown - Create new dropdown menus for your navigation
  • Navbar Item - Add individual navigation links
  • Import API Docs - Bulk import documentation from API specifications

Creating New Content​

Right-Click Context Menu​

Right-click on any item or empty space to see available actions. The menu is smart - it only shows options that make sense for what you clicked on.

Organizing with Drag and Drop​

Visual Drag and Drop​

Click and drag any item to move it around:

  • Blue highlights show where you can drop items
  • Blue lines indicate if items will go before, after, or inside containers
  • Auto-expansion - folders open automatically when you drag items over them

Best Practices​

  1. Plan your structure first - sketch out your organization before creating lots of content
  2. Use clear, descriptive names that explain the content
  3. Keep hierarchy shallow - Avoid too many nested levels (3-4 levels maximum)
  4. Group related content together in the same category or group

The file tree grows with your documentation - start simple and add complexity as needed!